home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / Libraries / ABox 1.9.5 / ABox info... / About the ABox... / 1-Using the ABox / 1-Using the ABox.rsrc / TEXT_227_Using the ABox.txt < prev    next >
Encoding:
Text File  |  1994-07-15  |  2.2 KB  |  32 lines

  1. The ABox is a multi-purpose dialog box that can be used to provide a user with a list of topics, where each list contains one or more "slides" on that topic. The ABox is depicted below in a rough diagram:
  2.  
  3. [ Please forgive the crude ASCII graphics, but you are looking at the real ABox while reading this after-all ]
  4.  
  5.     +--------------------------------------+
  6.     |+-----------+-+ +------------------+-+|
  7.     || topic     |^| | slide field      |^||
  8.     || list with | | | for PICT and     | ||
  9.     || scrollbar | | | TEXT (styled too)| ||
  10.     ||           | | | with scrollbar   | ||
  11.     ||           | | | as required      | ||
  12.     ||           | | |                  | ||
  13.     ||           |v| |                  |v||    
  14.     |+-----------+-+ +------------------+-+|
  15.     |                +------------------+  |
  16.     |                |  slide title STR |  |
  17.     | version info   +------------------+  |
  18.     | ^0^1^2^3       Play <<   >>      OK  |
  19.     +--------------------------------------+
  20.                       prev & next buttons
  21.  
  22.  
  23. Topics (and their respective slides within the topics) are just loose files within a predetermined folder, possibly organized
  24. with subfolders. This folder (specified by the application programmer) is recursively walked to gather up a topic list, which is simply a list of files that contain TSAb resources (more on this later), and is then displayed in the left area of  the dialog box. This way we can create a poor-person's outline just by organizing the topic/slide files into folders and subfolders. Subtopics (and subfolders) are appropriately indented in the topic list. If a folder contains a file of the same name, the file is substituted for the folder name and displayed in the list where the folder would be.
  25.  
  26. When the user clicks either the "<<prev<<" or ">>next>>" buttons the previous or next slide in the current slide list is displayed. The buttons are appropriately disabled when at the start or end of a slide list. The left/right arrow keys are keyboard shortcuts for the previous and next buttons.
  27.  
  28. Additionally, the "play" button (or the spacebar, as a shortcut) will cause the slide's sound or controller-less movie to replay
  29. (movies that have a controller already provide their own play button).
  30.  
  31. The up/down arrow keys will traverse the topic list.
  32.